GET Hero Recommended Builds
/openmlbb/academy/heroes/{hero_identifier}/builds
API Path: /api/academy/heroes/{hero_identifier}/builds
Path parameters:
- hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like
30,Yi Sun-shin, oryisunshin.
Query parameters:
- rank: Rank filter. Allowed values:
all,epic,legend,mythic,honor,glory. - lane: Lane. Allowed values:
exp,mid,roam,jungle,gold. from/api/academy/heroes/{hero_identifier}/lane - size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes hero build data:
- records: Array of build entries, each containing:
- _id: Unique record identifier.
- _createdAt: Creation timestamp.
- _updatedAt: Last update timestamp.
- data:
- heroid: Hero ID.
- hero_name: Hero name.
- real_road: Lane assignment ID.
- build: Array of recommended builds, each containing:
- equipid: List of equipment IDs.
- emblem: Emblem configuration:
- emblemid: Emblem ID.
- emblemname: Emblem name.
- emblemattr: Emblem attributes (e.g., '+10% Spell Vamp').
- attriicon: Emblem attribute icon URL.
- battleskill: Battle spell configuration:
- battleskillid: Battle spell ID.
- skillname: Spell name (e.g., 'Retribution').
- skillshortdesc: Short description.
- skilldesc: Full description of spell effects.
- skillicon: Spell icon URL.
- runeid: Rune ID.
- new_rune_skill: Array of rune skill IDs.
- build_pick_rate: Pick rate of the build.
- build_win_rate: Win rate of the build.
This endpoint is useful for:
- Displaying historical or community-recommended builds.
- Providing backward compatibility for older integrations.
- Should be replaced with newer endpoints for up-to-date build recommendations.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.hero_builds("miya", lane="exp", rank="all", size=20, index=1, lang="en")
print(response)
Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| hero_identifier | path | string | yes | - |
| lane | query | string | yes | - |
| rank | query | string | no | all |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |